[DNS] Zone conversions guides #17088

RebeccaTamachiro · 2024-09-25T11:30:39Z

Summary

PCX-8015: Document zone setup conversions

Documentation checklist

The documentation style guide has been adhered to.
Files which have changed name or location have been allocated redirects.

cloudflare-workers-and-pages · 2024-09-25T11:36:41Z

Deploying cloudflare-docs with Cloudflare Pages

Latest commit:	`101d0d9`
Status:	✅ Deploy successful!
Preview URL:	https://123c608a.cloudflare-docs-7ou.pages.dev
Branch Preview URL:	https://rebecca-dns-zone-setup-conve.cloudflare-docs-7ou.pages.dev

View logs

github-actions · 2024-09-25T11:36:57Z

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/dns/zone-setups/conversions/convert-secondary-to-partial/	https://rebecca-dns-zone-setup-conve.cloudflare-docs-7ou.pages.dev/dns/zone-setups/conversions/convert-secondary-to-partial/
https://developers.cloudflare.com/dns/zone-setups/conversions/convert-full-to-secondary/	https://rebecca-dns-zone-setup-conve.cloudflare-docs-7ou.pages.dev/dns/zone-setups/conversions/convert-full-to-secondary/
https://developers.cloudflare.com/dns/zone-setups/conversions/convert-secondary-to-full/	https://rebecca-dns-zone-setup-conve.cloudflare-docs-7ou.pages.dev/dns/zone-setups/conversions/convert-secondary-to-full/
https://developers.cloudflare.com/dns/zone-setups/conversions/	https://rebecca-dns-zone-setup-conve.cloudflare-docs-7ou.pages.dev/dns/zone-setups/conversions/
https://developers.cloudflare.com/dns/zone-setups/conversions/convert-partial-to-full/	https://rebecca-dns-zone-setup-conve.cloudflare-docs-7ou.pages.dev/dns/zone-setups/conversions/convert-partial-to-full/
https://developers.cloudflare.com/dns/zone-setups/conversions/convert-partial-to-secondary/	https://rebecca-dns-zone-setup-conve.cloudflare-docs-7ou.pages.dev/dns/zone-setups/conversions/convert-partial-to-secondary/
https://developers.cloudflare.com/dns/zone-setups/conversions/convert-full-to-partial/	https://rebecca-dns-zone-setup-conve.cloudflare-docs-7ou.pages.dev/dns/zone-setups/conversions/convert-full-to-partial/
https://developers.cloudflare.com/dns/zone-setups/partial-setup/	https://rebecca-dns-zone-setup-conve.cloudflare-docs-7ou.pages.dev/dns/zone-setups/partial-setup/
https://developers.cloudflare.com/dns/zone-setups/removal/	https://rebecca-dns-zone-setup-conve.cloudflare-docs-7ou.pages.dev/dns/zone-setups/removal/

github-actions · 2024-10-01T13:55:31Z

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

/dns/zone-setups/partial-setup/convert-partial-to-full/
/dns/zone-setups/partial-setup/convert-partial-to-secondary/

src/content/docs/dns/zone-setups/conversions/convert-full-to-secondary.mdx

Oxyjun · 2024-10-15T12:41:03Z

src/content/docs/dns/zone-setups/conversions/convert-full-to-secondary.mdx

+3. Link the peer server you created in the previous steps and select **Save**.
+4. On  **DNS** > **Settings**, select **Initiate zone transfer**.
+5. Confirm the DNS records are transferring as expected.
+6. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare Nameservers**.


Suggested change

6. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare Nameservers**.

6. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare nameservers**.

I could be wrong on this, but in the same way we say Cloudflare dashboard (lowercase "d"), I thought maybe this should be Cloudflare nameservers, with a lowercase n.

I agree with this reasoning and have used nameservers elsewhere, but have kept it like this in these guides to mirror the card name in the dashboard.

Oxyjun · 2024-10-15T12:42:03Z

src/content/docs/dns/zone-setups/conversions/convert-secondary-to-full.mdx

+
+## 2. Prepare for the conversion
+
+1. Plan for [DNSSEC settings](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/). If you were previously using [Pre-signed DNSSEC](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/#set-up-pre-signed-dnssec), consider disabling DNSSEC before starting the conversion.


Suggested change

1. Plan for [DNSSEC settings](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/). If you were previously using [Pre-signed DNSSEC](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/#set-up-pre-signed-dnssec), consider disabling DNSSEC before starting the conversion.

1. Plan for [DNSSEC settings](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/). If you were previously using [presigned DNSSEC](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/#set-up-pre-signed-dnssec), consider disabling DNSSEC before starting the conversion.

I've seen both presigned and pre-signed being used in the docs. Happy to be overruled here.

Oxyjun · 2024-10-15T12:44:29Z

src/content/docs/dns/zone-setups/conversions/convert-secondary-to-full.mdx

+1. Plan for [DNSSEC settings](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/). If you were previously using [Pre-signed DNSSEC](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/#set-up-pre-signed-dnssec), consider disabling DNSSEC before starting the conversion.
+2. Make sure the [proxy statuses](/dns/manage-dns-records/reference/proxied-dns-records/) of your DNS records are consistently set:
+
+    - If you have [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/), confirm each record has the appropriate setting (**Proxied** or **DNS only**).


Suggested change

- If you have [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/), confirm each record has the appropriate setting (**Proxied** or **DNS only**).

- If you have [secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/), confirm each record has the appropriate setting (**Proxied** or **DNS only**).

I think we've been consistently using the capitalized form, as this is considered the name of a Cloudflare feature.

Oxyjun · 2024-10-15T12:44:38Z

src/content/docs/dns/zone-setups/conversions/convert-secondary-to-full.mdx

+2. Make sure the [proxy statuses](/dns/manage-dns-records/reference/proxied-dns-records/) of your DNS records are consistently set:
+
+    - If you have [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/), confirm each record has the appropriate setting (**Proxied** or **DNS only**).
+    - If [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/) is disabled, make sure all of your DNS records are listed as **DNS only**.


Suggested change

- If [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/) is disabled, make sure all of your DNS records are listed as **DNS only**.

- If [secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/) is disabled, make sure all of your DNS records are listed as **DNS only**.

src/content/docs/dns/zone-setups/conversions/convert-secondary-to-full.mdx

Oxyjun · 2024-10-15T12:45:48Z

src/content/docs/dns/zone-setups/conversions/convert-secondary-to-full.mdx

+## 3. Convert your zone
+
+1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `full`, to convert the zone type. Existing DNS records will not be affected.
+2. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare Nameservers**.


Suggested change

2. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare Nameservers**.

2. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare nameservers**.

src/content/docs/dns/zone-setups/conversions/convert-secondary-to-partial.mdx

Co-authored-by: Jun Lee <[email protected]>

hyperlint-ai

11 files reviewed, 3 total issue(s) found.

hyperlint-ai · 2024-10-15T13:13:53Z

src/content/docs/dns/zone-setups/conversions/convert-secondary-to-partial.mdx

+## 3. Convert your Cloudflare zone
+
+1. Back at your Cloudflare zone, confirm that you have all the `A`, `AAAA`, or `CNAME` [DNS records](/dns/manage-dns-records/how-to/create-dns-records/) needed for the hostnames you pointed to `{your-hostname}.cdn.cloudflare.net` in the previous step. You can also delete any DNS records that have a different type, as they will no longer resolve once you convert your zone to a partial setup.
+2. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `partial` to convert the zone type. Existing DNS records will not be affected.


Suggested change

2. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `partial` to convert the zone type. Existing DNS records will not be affected.

2. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `partial` convert the zone type. Existing DNS records will not be affected.

Issues:

Style Guide - (Repetition-error) 'to' is repeated!

Style Guide - (cloudflare.Repetition-warning) Warning: Remove this duplicate word: 'to'.

Fix Explanation:

The repetition of the word 'to' is a simple error that can be corrected by removing the second occurrence. The sentence remains clear and retains its intended meaning without the duplicate word.

hyperlint-ai · 2024-10-15T13:13:53Z

src/content/docs/dns/zone-setups/conversions/convert-secondary-to-full.mdx

+
+## 3. Convert your zone
+
+1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `full` to convert the zone type. Existing DNS records will not be affected.


Suggested change

1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `full` to convert the zone type. Existing DNS records will not be affected.

1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `full` convert the zone type. Existing DNS records will not be affected.

Issues:

Style Guide - (Repetition-error) 'to' is repeated!

Style Guide - (cloudflare.Repetition-warning) Warning: Remove this duplicate word: 'to'.

Fix Explanation:

The word 'to' is repeated unnecessarily in the sentence. Removing the second 'to' maintains the intended meaning and improves readability. The sentence now reads more smoothly without the repetition.

hyperlint-ai · 2024-10-15T13:13:53Z

src/content/docs/dns/zone-setups/conversions/convert-full-to-secondary.mdx

+
+## 3. Convert the zone and initiate zone transfers
+
+1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `secondary` to convert the zone type. The existing records will remain in place.


Suggested change

1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `secondary` to convert the zone type. The existing records will remain in place.

1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `secondary` convert the zone type. The existing records will remain in place.

Issues:

Style Guide - (cloudflare.Repetition-warning) Warning: Remove this duplicate word: 'to'.

Style Guide - (Repetition-error) 'to' is repeated!

Fix Explanation:

The word 'to' is repeated unnecessarily. Removing the duplicate 'to' resolves the issue without altering the meaning of the sentence. The sentence remains clear and concise after the correction.

Create conversions folder and add .mdx files of new guides

296acff

github-actions bot added size/m product:dns Issues or PRs related to DNS labels Sep 25, 2024

RebeccaTamachiro added 8 commits September 25, 2024 13:58

Process comments from gdoc review for full-to-secondary

a4d8670

Process comments from gdoc review for secondary-to-full

6e0373b

Add note about read-only state after unlinking peers

090f859

Move repeated text into partial and apply it

5357ae4

Review convert-secondary-to-partial

492015a

Move partial docs to conversions folder, re-order, and add redirects

c72ba63

For completeness, add external_link page pointing to partial-setup/setup

3c15ce5

Merge 'production'

8de727a

RebeccaTamachiro added 4 commits October 1, 2024 15:16

Fix broken link and list convert-partial-to-secondary as well

f18834b

Add correct link for convert-partial-to-secondary

dad7597

Merge branch 'production'

d64553d

Add call out regarding subdomain setup as per PM suggestion

fdc7f24

RebeccaTamachiro marked this pull request as ready for review October 14, 2024 16:21

RebeccaTamachiro requested review from a team, GregBrimble, KianNH, WalshyDev and pedrosousa as code owners October 14, 2024 16:21

Explicitly state what NS updates could be needed as per PM suggestion

50c8829

RebeccaTamachiro enabled auto-merge (squash) October 14, 2024 17:26

RebeccaTamachiro disabled auto-merge October 14, 2024 17:54

Oxyjun reviewed Oct 15, 2024

View reviewed changes

src/content/docs/dns/zone-setups/conversions/convert-full-to-secondary.mdx Outdated Show resolved Hide resolved

Oxyjun reviewed Oct 15, 2024

View reviewed changes

src/content/docs/dns/zone-setups/conversions/convert-secondary-to-full.mdx Outdated Show resolved Hide resolved

Oxyjun reviewed Oct 15, 2024

View reviewed changes

src/content/docs/dns/zone-setups/conversions/convert-secondary-to-partial.mdx Outdated Show resolved Hide resolved

Oxyjun reviewed Oct 15, 2024

View reviewed changes

src/content/docs/dns/zone-setups/conversions/convert-secondary-to-partial.mdx Outdated Show resolved Hide resolved

Oxyjun approved these changes Oct 15, 2024

View reviewed changes

Apply suggestions from code review

101d0d9

Co-authored-by: Jun Lee <[email protected]>

hyperlint-ai bot reviewed Oct 15, 2024

View reviewed changes

RebeccaTamachiro merged commit 1083cf4 into production Oct 15, 2024
12 of 13 checks passed

RebeccaTamachiro deleted the rebecca/dns-zone-setup-conversions branch October 15, 2024 13:36

RebeccaTamachiro mentioned this pull request May 6, 2025

[DNS] Remove secondary to primary limitation callout #22248

Merged

	6. Go to [DNS > Records](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new Cloudflare Nameservers.
	6. Go to [DNS > Records](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new Cloudflare nameservers.


		## 2. Prepare for the conversion

		1. Plan for [DNSSEC settings](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/). If you were previously using [Pre-signed DNSSEC](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/#set-up-pre-signed-dnssec), consider disabling DNSSEC before starting the conversion.

	- If you have [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/), confirm each record has the appropriate setting (Proxied or DNS only).
	- If you have [secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/), confirm each record has the appropriate setting (Proxied or DNS only).

	- If [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/) is disabled, make sure all of your DNS records are listed as DNS only.
	- If [secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/) is disabled, make sure all of your DNS records are listed as DNS only.

	2. Go to [DNS > Records](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new Cloudflare Nameservers.
	2. Go to [DNS > Records](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new Cloudflare nameservers.

	2. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `partial` to convert the zone type. Existing DNS records will not be affected.
	2. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `partial` convert the zone type. Existing DNS records will not be affected.


		## 3. Convert your zone

		1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `full` to convert the zone type. Existing DNS records will not be affected.


		## 3. Convert the zone and initiate zone transfers

		1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `secondary` to convert the zone type. The existing records will remain in place.

[DNS] Zone conversions guides #17088

[DNS] Zone conversions guides #17088

Conversation

RebeccaTamachiro commented Sep 25, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Documentation checklist

Uh oh!

cloudflare-workers-and-pages bot commented Sep 25, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying cloudflare-docs with Cloudflare Pages

Uh oh!

github-actions bot commented Sep 25, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Oct 1, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Oxyjun Oct 15, 2024

Choose a reason for hiding this comment

Uh oh!

RebeccaTamachiro Oct 15, 2024

Choose a reason for hiding this comment

Uh oh!

Oxyjun Oct 15, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Oxyjun Oct 15, 2024

Choose a reason for hiding this comment

Uh oh!

RebeccaTamachiro Oct 15, 2024

Choose a reason for hiding this comment

Uh oh!

Oxyjun Oct 15, 2024

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Oxyjun Oct 15, 2024

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

hyperlint-ai bot left a comment

Choose a reason for hiding this comment

Uh oh!

hyperlint-ai bot Oct 15, 2024

Choose a reason for hiding this comment

Uh oh!

hyperlint-ai bot Oct 15, 2024

Choose a reason for hiding this comment

Uh oh!

hyperlint-ai bot Oct 15, 2024

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

RebeccaTamachiro commented Sep 25, 2024 •

edited

Loading

cloudflare-workers-and-pages bot commented Sep 25, 2024 •

edited

Loading

github-actions bot commented Sep 25, 2024 •

edited

Loading

github-actions bot commented Oct 1, 2024 •

edited

Loading

Oxyjun Oct 15, 2024 •

edited

Loading